fontchooserdialog: Convert docs

diff --git a/gtk/gtkfontchooserdialog.c b/gtk/gtkfontchooserdialog.c
index 5c38db7fa8d2b1c2e23f988a1c072a0546054b52..3d360cf2ecfbcb5b0214c9620a0de7a5e50c8fc7 100644 (file)
--- a/gtk/gtkfontchooserdialog.c
+++ b/gtk/gtkfontchooserdialog.c
@@ -56,17 +56,20 @@ struct _GtkFontChooserDialogClass
 };
 
 /**
- * SECTION:gtkfontchooserdialog
- * @Short_description: A dialog for selecting fonts
- * @Title: GtkFontChooserDialog
- * @See_also: #GtkFontChooser, #GtkDialog
+ * GtkFontChooserDialog:
  *
- * The #GtkFontChooserDialog widget is a dialog for selecting a font.
- * It implements the #GtkFontChooser interface.
+ * The `GtkFontChooserDialog` widget is a dialog for selecting a font.
+ *
+ * ![An example GtkFontChooserDialog](fontchooser.png)
+ *
+ * `GtkFontChooserDialog` implements the [iface@Gtk.FontChooser] interface
+ * and does not provide much API of its own.
+ *
+ * To create a `GtkFontChooserDialog`, use [ctor@Gtk.FontChooserDialog.new].
  *
  * # GtkFontChooserDialog as GtkBuildable
  *
- * The GtkFontChooserDialog implementation of the #GtkBuildable
+ * The `GtkFontChooserDialog` implementation of the `GtkBuildable`
  * interface exposes the buttons with the names “select_button”
  * and “cancel_button”.
  */
@@ -281,9 +284,9 @@ gtk_font_chooser_dialog_init (GtkFontChooserDialog *dialog)
  * @title: (allow-none): Title of the dialog, or %NULL
  * @parent: (allow-none): Transient parent of the dialog, or %NULL
  *
- * Creates a new #GtkFontChooserDialog.
+ * Creates a new `GtkFontChooserDialog`.
  *
- * Returns: a new #GtkFontChooserDialog
+ * Returns: a new `GtkFontChooserDialog`
  */
 GtkWidget*
 gtk_font_chooser_dialog_new (const char *title,